Skip to content

fix(docs): fix documentation errors in docs#165

Open
Peopl3s wants to merge 1 commit into
kraken-tech:mainfrom
Peopl3s:docs/fix-docs-164
Open

fix(docs): fix documentation errors in docs#165
Peopl3s wants to merge 1 commit into
kraken-tech:mainfrom
Peopl3s:docs/fix-docs-164

Conversation

@Peopl3s
Copy link
Copy Markdown

@Peopl3s Peopl3s commented May 24, 2026

Closes #164

@Peopl3s Peopl3s requested a review from a team as a code owner May 24, 2026 05:28
Copy link
Copy Markdown
Collaborator

@LilyFirefly LilyFirefly left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this! Once we've decided how to handle part_of_a_transaction, I'm happy for this to be merged!

If you're testing [`transaction_required`][django_subatomic.db.transaction_required] code directly,
and you're _sure_ that the code shouldn't be responsible for opening a transaction,
use the [`part_of_a_transaction`][django_subatomic.test.part_of_a_transaction] decorator/context-manager
use the [`part_of_a_transaction`][django_subatomic.test.part_of_a_transaction] context manager
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

part_of_a_transaction can actually be used as a decorator, since it is defined using contextlib.contextmanager.

That said, I wonder if it would make sense to restrict this down to just a context manager, like we do with savepoint?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Several documentation errors

2 participants